Skip to content

publish v1.YYMMDD.N go-modules mirror tags#120

Open
Jolymmiles wants to merge 1 commit intoXTLS:mainfrom
Jolymmiles:feat/go-modules-semver-mirror
Open

publish v1.YYMMDD.N go-modules mirror tags#120
Jolymmiles wants to merge 1 commit intoXTLS:mainfrom
Jolymmiles:feat/go-modules-semver-mirror

Conversation

@Jolymmiles
Copy link
Copy Markdown

CalVer tags vYY.M.D have major >= 2, which per the Go modules spec forces consumers onto pseudo-versions (commit-pinned go get) unless the import path carries a /vN suffix. Bumping the suffix every January would break every downstream import once a year.

Mirror each CalVer release onto a SemVer-shaped tag on the same commit (v26.3.27 → v1.260327.0). Major stays at 1, no import-path churn, and go get github.com/xtls/libxray@v1.260327.0 resolves cleanly. Same scheme xray-core uses.

  • .github/workflows/release-go-mirror.yml: auto-create v1.* tag on every CalVer push, with recursion guard and CalVer-range validation
  • scripts/backfill-semver-tags.sh: one-shot history backfill, idempotent; pass --push to publish
  • README.md: document the convention for Go consumers

CalVer tags vYY.M.D have major >= 2, which per the Go modules spec forces
consumers onto pseudo-versions (commit-pinned `go get`) unless the import
path carries a /vN suffix. Bumping the suffix every January would break
every downstream import once a year.

Mirror each CalVer release onto a SemVer-shaped tag on the same commit
(v26.3.27 → v1.260327.0). Major stays at 1, no import-path churn, and
`go get github.com/xtls/libxray@v1.260327.0` resolves cleanly. Same scheme
xray-core uses.

- .github/workflows/release-go-mirror.yml: auto-create v1.* tag on every
  CalVer push, with recursion guard and CalVer-range validation
- scripts/backfill-semver-tags.sh: one-shot history backfill, idempotent;
  pass --push to publish
- README.md: document the convention for Go consumers
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant